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INTRODUCTION 


This guide lists the commands (PCOS and 8AS1C), 
edit mode subcommands, BASIC statements, and 
built-in functions of the Olivetti LI M20 micro¬ 
computer, and provides a general description of 
each. Within each category, items are presented 
alphabetically. The guide also includes informa¬ 
tion on the use of the Control key, a list of 
error messages with explanations, and the ASCII 
table shown with numeric equivalences for each of 
its characters. 

The guide is intended for reference only and 
assumes a familiarity with PCOS, the BASIC 
language, and the M20. For a complete description 
of the system, the language, and the M20, see the 
publications: 

LI M20 

Professional Computer 
Operating System (PCOS) 

User Guide 

code 3987590 U (0) 

LI M20 

BASIC Language 
Reference Guide 
code 3982430 P (1) 

Distribution: General (G) 

1st Edition: August 1982 

Release: 1.2 


PUBLICATION ISSUED BY: 

lng. C. Olivetti & C., S.p.A. 
Servizio Centrale Documentazione 
77, Via Jervis - 10015 Ivrea (Italy) 

© 1982, by Olivetti 
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Notation Conventions 

Syntax diagrams are used to describe the commands, 
statements, and functions in this guide. A syntax 
diagram is a flowchart with one entry and one 
exit. Each path through the flowchart shows an 
allowable sequence of symbols. The diagrams are 
read from left to right. 

. Items enclosed in ovals or circles, if selected, 
must be entered exactly as shown. 

. Items enclosed in rectangles, if selected, must 
be replaced by information supplied by the user. 
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BASIC COMMANDS 
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BASIC COMMANDS 
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BASIC COMMANDS 
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BASIC STATEMENTS 















(COMMENT FIELD) 
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DEFDBL 
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BASIC STATEMENTS 
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BASIC STATEMENTS 





























NANE FUNCTION FORHAT 
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BASIC STATEMENTS 
























FUNCTION FORHAT 



41 


BASIC STATEMENTS 































FUNCTION FORMAT 
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ON...GOSUB 
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BASIC STATEMENTS 
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PRINT USING 
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BASIC STATEMENTS 
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BASK STATEMENTS 


















NAME FUNCTION FORMAT 
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BASIC STATEMENTS 

























FUNCTION FORMAT 
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BASIC STATEMENTS 
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NAME FUNCTION FORMAT 
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CLOSE WINDOW 
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BASIC STATEMENTS FOR GRAPHICS 
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90 WINDOW %A 
















BASIC STATEMENTS FOR GRAPHICS 





























































































































































STRING BUILT-IN FUNCTIONS 
















NANE VALUE RETURNED FORMAT 



I/O AND SPECIAL BUILT-IN FUNCTIONS 
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I/O AND SPECIAL BUILT-IN FUNCTIONS 





























































PRINT CONTROL BUILT-IN FUNCTIONS 



The video file editor is invoked, from PCOS, via the EDIT command. Once EDIT has been issued, the keyboard operates as indica¬ 
ted in the following diagrams. The characters shown on the "Top Row Function Keys" --(1),(2), ...( ) — are those that appear 
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ALPHA KEYS with CTRL 







VIDEO FILE EDITOR 











VIDEO FILE EDITOR COMMANDS 



DEVICE RE-ROUTING 
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lijote that + or S or D and device name or file name follow each other without any spaces irr between, and constitutes one 
device re-routing parameter. Each device re-routing parameter must be followed by a comma to separate it from the next device 
re-routing parameter. Note also that -i-drpt: may also be written as +prt (in capital or small letters)._ 




Adding simply +PRT to a command — for example: 
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DEVICE RE-ROUTING 






GLOBAL DEVICE RE-ROUTING 
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DEVICE RE-ROUTING 



APPENDIX A EDIT MODE SUBCOMMANDS 

An EDIT command must be issued before any of the 

following subcommands can be used. 

SUBCOMMAND FUNCTION 

A Restores the line as it was and 

restarts editing from the start of 
the line 

Displ ays the newly modified line, 
exits from edit mode, and returns 
to command mode 

Changes the next n characters in 
the line to the characters entered 
from the keyboard. (The number of 
characters entered must equal the 
value of n.) 

n D Deletes n characters starting from 

the position of the cursor 

E Ends editing, returns to Command 

mode, saves changes, but does not 
display the rest of the line 

H characters Deletes the rest of the line, 

starting from the position of the 
cursor, and allows the optional 
insertion of characters at that 
point 

I characters Inserts the characters keyed in on 
the keyboard at the position of 
the cursor. (To end insert state, 
press KNii.lM BihliM to continue 
editing the line, or K«I:M to exit 
from edit mode.) 

n K character Kills all characters up to the nth 
occurrence of Charact er 

L Lists the rest of the line, from 

the position of the cursor and re¬ 
turns to the start of the line 


n C chara¬ 
cters 
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Q 


n S character 


X characters 


Restores the line as it was and 
exits from edit mode into command 
mode 

Searches for the nth occurrence of 
c haracter and positions the cursor 
in front of it 

Inserts characters at the end of 
the line 
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APPENDIX B USE OF THE CONTROL KEY 

The Control Key HitliM is pressed together with 
other keys to perform 3 number of special oper¬ 
ations. The correspondence between the keys press¬ 
ed and the operation performed is shown below. 


KEYS PRESSED OPERATION PERFORMED 

MB Activates the Break facility 

to delete the line being typed. 
Interrupts program execution or 
automatic line numbering and 
returns the M20 to BASIC command 
mode 

MlTBB m Suppresses the display or print¬ 

ing of the characters about to 
be entered 

i»i:M Bill Deletes the last character en¬ 

tered 

Mi-Tin IBBI Provides a tab of eight spaces 

d Suspends program execution or 

listing (to resume, press any 
key.) 

■BfiW O Deletes the line being typed 

Exits insert state without exit¬ 
ing edit mode 

■ma* Clears memory and reloads PCOS 

and BASIC from disk 
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APPENDIX C ERROR MESSAGES AND CODES 


ERROR 

CODE 


MESSAGE 


EXPLANATION 


1 NEXT WITHOUT 

FOR 


2 SYNTAX ERROR 


3 RETURN WITHOUT 

GOSUB 


4 OUT OF DATA 


5 ILLEGAL FUNCTION 

CALL 


A NEXT statement has 
been encountered without 
a matching FOR. 

A line has been encoun¬ 
tered which includes an 
incorrect sequence of 
characters (misspelled 
keyword, incorrect punc¬ 
tuation, etc.). 

A RETURN has been en¬ 
countered for which t- 
here is no previous 
unmatched GOSUB state¬ 
ment. 

A READ statement has 
been executed when there 
are no DATA statements 
with unread data remain¬ 
ing in the program. 

A parameter that is out 
of range has been passed 
to a mathematical or 
string function. This 
error may also occur 
with invalid arguments 
in function parameters 
or an ON...GOTO, and 
when: 

a. An array subscript is 
either negative or 
too large. 

b. A log function is 
assigned a negative 
or a null argument. 
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OVERFLOW 


OUT OF MEMORY 


UNDEFINED LINE 
NUMBER 


SU3SCRIPT OUT 
OF RANGE 


DUPLICATE 

DEFINITION 


c. The SQR function is 
assigned a negative 
value. 

d. A negative value has 
a non-integer expo- 
ne nt. 

e. A USR function has 
been called without 
having an initial 
address established. 

The result of a calcu¬ 
lation is too large to 
be represented in BA¬ 
SIC's number format. 

Note: With underflow, 

the result is taken as 
zero, and execution 
continues without indi¬ 
cation of an error. 

A program is too big; or 
has too many loops, 
GOSIJSs or variables; or 
has expressions too com¬ 
plicated to evaluate. 

A line reference is to a 
non-existent line from a 
GOTO, GOSUB, IF..THEN- 
..ELSE or DELETE state¬ 
ment . 

An array element has 
been referred to either 
with a subscript that is 
outside the dimensions 
of the array or with the 
wrong number of sub¬ 
scripts. 

Two DIM statements have 
been given for the same 
array, or a DIM state¬ 
ment has also been ap- 



DIVISION 8Y 
ZERO 


ILLEGAL DIRECT 


TYPE MISMATCH 


OUT OF STRING 
SPACE 


plied to an array after 
the default dimension of 
10 was previously estab¬ 
lished for that array. 

A division by zero has 
been encountered or the 
value zero has been 
raised to a negative 
power. In the former 
case, the result is 
machine infinity (with 
the appropriate sign); 
in the latter, the re¬ 
sult is positive machine 
infinity. 

A statement which is 
invalid in immediate 
(direct) mode has been 
entered as an immediate 
command. 

A string variable name 
has been assigned a 
numeric value or vice- 
versa; a function that 
expects a numeric argu¬ 
ment has been given a 
string argument or vice 
versa. 

String variables have 
caused BASIC to exceed 
the amount of free user 
memory remaining. (BASIC 
will allocate space dy¬ 
namically until it runs 
out of memory.) 

An attempt has been made 
to create a string more 
than 255 characters 
long. 


STRING TOO LONG 



16 STRING FORMULA 

TOO COMPLEX 


17 CAN’T CONTINUE 

18 UNDEFINED USER 
FUNCTION 

19 NO RESUME 

20 RESUME WITHOUT 
ERROR 

21 UNPRINTABLE 
ERROR 


22 MISSING OPERAND 


23 LINE BUFFER 
OVERFLOW 

24 Unprintable error 

25 Unprintable error 


A string expression is 
too long or too complex 
to be processed. It 
should be broken into 
smaller expressions. 

An attempt has been made 
to continue a program 
that is noncontinuable; 
as it is halted due to 
an error, was modified 
during a break in execu¬ 
tion, or does not exist. 

A function has been 
called that has not been 
previously defined. 

An error-trapping rou¬ 
tine has been entered 
that contains no RESUME 
statement. 

A RESUME statement has 
been encountered before 
an error-trapping rou¬ 
tine is entered. 

An error message is not 
printable i.e. corre¬ 
sponds to an error with 
an undefined error code. 

An expression contains 
an operator but no fol¬ 
lowing operand. 

An attempt has been made 
to enter a line with 
more than 255 charac¬ 
ters. 
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26 


FOR WITHOUT NEXT A FOR has been encoun- 




tered with out a match¬ 
ing NEXT. 

29 

WHILE WITHOUT 

WEND 

A WHILE has been encoun¬ 
tered without a matching 
WEND. 

30 

LEND WITHOUT 

WHILE 

A WEND has been encoun¬ 
tered without a matching 
WHILE. 

31 

IEEE INVALID 

TALKER/LISTENER 

ADDRESS 

Use of invalid talker 
listener address. 

32 

IEEE: TALKER = 
LISTENER 

ADDRESS 

An attempt has been made 
to talk to a talker, or 
listen to a listener. 

33 

IEEE: UNPRINTABLE 
ERROR 

An error message is not 
printable i.e. corre¬ 
sponds to an error with 
an undefined error code. 

34 

IEEE: BOARD NOT 
PRESENT 

An attempt has been made 
to use IEEE on a machine 
which does not have the 
optional IEEE interface. 

35 

WINDOW NOT OPEN 

An attempt has been made 
to use a window which is 
not currently open. 

36 

UNABLE TO CREATE 
WINDOW 

The window to be created 
is too big or too small 
for its mode (graphics 
or text). 

37 

INVALID ACTION 
VERB 

An action verb has been 
incorrectly spelled or 
used. 

38 

PARAMETER OUT 

OF RANGE 

One or more parameters 
have exceeded the limits 
set for their range. 
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TOO MANY 
DIMENSIONS 


FIELD 

OVERFLOW 


INTERNAL ERROR 


BAD FILE 
NUMBER 


FILE NOT FOUND 


3AD FILE MODE 


FILE ALREADY 
OPEN 


An attempt has been made 
to use an array of more 
than one dimension in 
graphics mode. 

A FIELD statement has 
attempted to allocate 
more bytes than were 
specified for the record 
length of a random file. 

An internal malfunc¬ 
tion has occurred. 

Report the conditions 
under which the error 
occurred to your Support 
Organization. 

A statement or command 
refers to a file having 
a file number not within 
the range specified at 
initalization or the 
corresponding file is 
not open. 

A LOAD, KILL or OPEN 
statement refers to a 
file that does not exist 
on the current disk. 

An attep..pt has been made 
to use random file oper¬ 
ations (GET or PUT ) 
with a sequential file; 
to use the sequential 
operation LOAD with a 


random file; 

or to 

use 

an invalid 

file 

mode 

with OPEN, 

i. e. , 

riot 

A, 1,0, or R. 



A sequential 

0PEN.0, 

has 

been issued 

for a 

file 


that is already open, or 
a KILL has been applied 
to a file that is open. 



57 DISK 1/0 ERROR 

58 FILE ALREADY 
EXISTS 

61 DISK FULL 

62 INPUT PAST END 

63 BAD RE-CORD 
NUMBER 


64 BAD FILE NAME 


66 DIRECT STATE¬ 

MENT IN FILE 


An input/output error 
has occured during a 
disk I/O operation. 

The filename specified 
is identical to a file¬ 
name already in use on 
the disk. 

All disk storage space 
available is in use. 

An INPUT statement has 
been executed after all 
the data has been assi¬ 
gned, or for an empty 

(null) file. 

Note : The EOF function 

can be used to detect 
end of file. 

The record number used 
with a GET or PUT state¬ 
ment exceeds range, i.e. 
is 0 or greater than 

32767. 

An invalid form of file¬ 
name has been used with 
KILL, LOAD, OPEN or SAVE 
e.g.: 

- too long 

- includes invalid char¬ 
acters such as space 
or hyphen. 

A direct (immediate) 
statement has been en¬ 
countered when loading 
an ASCII format file. 

The LOAD operation is 
terminated. 
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67 


TOO MANY FILES 


69 VOLUME NAME 
NOT FOUND 


70 RENAME ERROR 


71 VOLUME NUMBER 
ERROR 


72 VOLUME NOT 
ENABLEO 
or 

FILE RENAME 
ERRR 


73 INVALID 

PASSWORD 
or 

INVALID VOLUME 
NUMBER 

75 WRITE PROTECTED 


or 

VOLUME NOT 
ENABLED 


76 ERROR IN 

PARAMETER 
or 

PASSWORD 
NOT VALID 


An attempt has been made 
to create a new file 
(using SAVE or OPEN) 
when the present. direc¬ 
tory is already full. 

The volume name speci¬ 
fied is not the name of 
any volume currently 
loaded. 

An error has been made 
during a rename oper¬ 
ation. 

An error has been made 
in specifying the volume 
number. 

A required password has 
not been specified. 

An error has occurred 
during a rename opera¬ 
tion. 

An invalid password has 
been specified. 

The volume number speci¬ 
fied is invalid. 

An attempt has been made 
to write to a file that 
is write-protected. 

The required volume 
password has not been 
specified. 

The parameter specified 
contains an error. 

An incorrect password 
has been specified. 
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77 

ILLEGAL DISK 
CHANGED 

or 

TOO MANY 
PARAMETERS 

Disk changed without 
closing files. 

The number of parameters 
specified exceeds the 
number required. 

78 

FILE NOT OPEN 

An attempt has been made 
to write to or read from 
a file that is not yet 
open. 

90 

ERROR IN 
PARAMETER 

One or more of the 
quoted parameters con¬ 
tains an unacceptable 
value. 

91 

TOO MANY 

Too many parameters have 


PARAMETERS 

been specified. 

92 

COMMAND NOT 

FOUND 

Use of invalid keyword 
or command not available 
as system software is 
not loaded. 

96 

FILE NOT OPEN 

The operation requested 
requires the specified 
file to be open. 

97 

READ FILE 

ERROR 

An error has been en¬ 
countered in reading 
from a file. 

98 

BAD LOAD FILE 
IDENTIFIER 

An incorrect file iden¬ 
tifier has been speci¬ 
fied. 

99 

BAD LOAD FILE 
VERSION NUMBER 

The specified version 
number is incorrect. 

100 

COMMAND ALREADY 
RESIDENT 

An attempt has been made 
to pload a resident 
command. 

101 

BAD DATE OPTION 

An invalid date has been 
specified. 


Ill 



102 

8AD TIME OPTION 

An invalid time has been 
specified. 

103 

GET DATE ERROR 

An error has been en¬ 
countered in a date 
operation. 

104 

GET TIME ERROR 

An error has been en¬ 
countered in a time 
operation. 

105 

BAD VERIFY 

OPTION 

An invalid verify has 
been requested. 

106 

FUNCTION KEY 
ALREADY DEFINED 

An attempt has been made 
to pkey a function to a 
key which has already 
been allotted a func¬ 
tion . 

108 

ERROR IN CALL 

USER INTERFACE 

An error has been en¬ 
countered in a call user 

interface. 

109 

PRINTER NOT 
CONNECTED 

The requested operation 
requires the connection 
of a printer. 

111 

INVALID 

DEVICE NAME 

Ari invalid device name 
has been specified. 

112 

INVALID 

DEVICE TYPE 

An invalid device type 
has been specified. 


112 



APPENDIX D ASCII CHARACTER CODE 

This table shows decimal, hexadecimal, and binary 
representation ,of the ASCII code. 



Note: Soxed characters are different on national 

keyboards (see Appendix E). 

a = Decimal b = Hexadecimal 

c = 8 bit Binary d = ASCII Code 

Representation 
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APPENDIX E ASCII CHARACTER EQUIVALENCES 


This table shows the national equivalences for 
those ASCII characters that appear on the video 
screen or printer in various national forms. 


ASCII VALUE 

NATIONAL EQUIVALENT 

DECIMAL 

HEXADECIMAL 

USA 

ITALY 

FRANCE 

z 

«< 

koc 

On 

GERMANY (1) 

GERMANY (2) 

Z 

i 

PORTUGAL 

DENMARK 

NORWAY 

SWEDEN 

FINLAND 

NORWAY 

SWITZERLAND 

FRENCH 

SWITZERLAND 

GERMAN 

35 

23 

© 

£ 

£ 

£ 

tt 

» 

£ 

» 

£ 

# 

£ 

£ 

£ 

36 

24 

© 

$ 

S 

$ 

$ 

$ 

S 

$ 

$ 

n 

$ 

S 

$ 

64 

40 

® 

§ 

a 

e 

§ 

§ 

§ 

§ 


e 


5 

§ 

91 

5B 

l 

0 

0 

I 

'A' 

X 

i 

5 

ft 

X 

ft 

a 

a 

92 

SC 

© 

9 

9 

\ 

0 

0 

N 

$ 

0 

0 

0 

9 

9 

93 

5D 

) 

e 

§ 

] 

u 

u 

C 

6 

A 

A 

A 

e 

e 

96 

60 


0 












123 

7B 

{ 

a 

e 

f 

a 

a 

• 

a 

* 

a 

* 

a 

a 

124 

7C 

1 

6 

i 

i 

6 

6 

n 

9 

* 

o 

i 

o 

8 

125 

70 

} 

e 

e 

} 

5 

a 

9 

0 

a 

a 

a 

a 

a 

126 

7E 

‘ 




(1 

fl 

- 

# 




e 

e 


used 


BASIC. 
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APPENDIX F COMMON TERMS USED IN FORMAT SPECIFICA- 
TIONS 


DRIVE NUMBER 



FILE - 
IDENTIFIER 



VOLUME - 
IDENTIFIER 



Note 

If drive-number is omitted, drive 0 is assumed by 
default unless dirve 1 was the last drive 
accessed. 
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APPENDIX G NUMERIC TYPE DECLARATION TAGS 


Listed below are the tags that can be appended 
to a numeric variable name to declare its type. 
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NOTICE 


Ing. C. Olivetti & C. S.p.A. reserves the right to 
make improvements in the product described in this 
manual at any time and without notice. 


Anything in the standard form of the Olivetti 
Sales Contract to the contrary not withstanding, 
all software being licensed to Customer is li¬ 
censed "as is". THERE ARE MO WARRANTIES EXPRESS OR 
IMPLIED INCLUDING WITHOUT LIMITATION THE IMPLIED 
WARRANTY OF FITNESS FOR PURPOSE AND OLIVETTI 
SHALL NOT BE LIABLE FOR ANY DIRECT, INDIRECT, 
CONSEQUENTIAL OR INCIDENTAL DAMAGES IN CONNECTION 
WITH SUCH SOFTWARE. 



Printed in Italy 
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